home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / inhlp11.zip / INSTAHLP.DOC < prev   
Text File  |  1988-02-26  |  15KB  |  331 lines
  1.  
  2.  
  3.                        Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988
  4.                               Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy
  5.  
  6.  
  7.           This package is intended for use with the Clipper Summer '87
  8.      compiler.  Use of any previous versions will NOT work.
  9.  
  10.           If you like what you see and want to use it in your programs,
  11.      I am asking $25 (U.S.) or your word as a fellow developer that the
  12.      library will either be destroyed or given to someone else to look
  13.      at.  An extra $25 (U.S.) and you will receive a copy of the source
  14.      to modify to your heart's content!!  Also, please feel free to
  15.      distribute this library to your friends/enemies.  And as always,
  16.      any comments, suggestions, death threats, etc... are welcome and
  17.      will be considered.
  18.  
  19.      Thanks, Richard.
  20.  
  21.           OK, on to more important subjects.  This package contains the
  22.      following programs/files:
  23.  
  24.           1) INHP11.LIB    --  The Instant Help v1.1 Library.
  25.           NOTE:  The HELP.* files are NOT part of the original package.
  26.                  They will be made if not currently present.
  27.           2) HELP.DBF      --  The database for your help screens.
  28.           3) HELP.DBT      --  The memo file for HELP.DBF.
  29.           4) HELP.NTX      --  The index created by HELP and INSTAHLP.
  30.           5) HLTEST.PRG    --  The demo test program.  Feel free to look
  31.                                at it to see how easy it is to use the
  32.                                system.  This program needs to be
  33.                                compiled by CLIPPER S'87 before you can
  34.                                link it.
  35.           6) INSTAHLP.DOC  -- This file you're reading right now.
  36.  
  37.      To link and run the demo;
  38.  
  39.           1) Compile HLTEST.PRG with CLIPPER S'87.
  40.           2) Link using CLIPPER.LIB, EXTEND.LIB and INHP11.LIB
  41.  
  42.              With DOS LINK:
  43.                 link hltest,,,clipper extend inhp11
  44.  
  45.              With PLINK86:
  46.                 PLINK86 FI HLTEST LIB CLIPPER, EXTEND, INHP11
  47.  
  48.      Execute HLTEST and enjoy!
  49.  
  50.      To link with your program, you will need to do the following:
  51.  
  52.          1)  Somewhere (I do it at the beginning) in your program put
  53.              the following instructions:
  54.  
  55.              external instahlp, help  && For making help screens.
  56.              set key 291 to instahlp  && Alt-H triggers creating help.
  57.  
  58.          This will cause link/plink86 to look for the modules INSTAHLP
  59.          and HELP in the library and set ALT-H to INSTAHLP.
  60.  
  61.  
  62.  
  63.                                     Page 1                                    Page 1                                    Page 1                                    Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                        Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988
  70.                               Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy
  71.  
  72.  
  73.           2)  Make sure you erase HELP.DBF, HELP.DBT and HELP.NTX from
  74.               the current directory (Of course, don't erase HELP if you
  75.               are currently working on it) and the programs will create
  76.               it the first time you press ALT-H.  At any time if you
  77.               suspect an index error, simply erase HELP.NTX and the
  78.               programs will re-create it.
  79.  
  80.  
  81.           3)  When you are done creating your help screens and are ready
  82.               to give the program to your customer, simply remove
  83.               "instahlp" from the external statement and delete (I
  84.               usually comment it out) the instruction -- set key 291 to
  85.               instahlp.  When the customer hits ALT-H, nothing will
  86.               happen, but when he hits F1 -- WOW!!
  87.  
  88.  
  89.                            **  RUN INSTRUCTIONS  **
  90.  
  91.           As you probably have figured out by now, to activate the
  92.      program, press ALT-H (assuming you have "set key 291 to instahlp"
  93.      in your program).  A box will appear in the upper left corner of
  94.      your screen.  Enter the screen number (1-9).  A bigger box will
  95.      appear to edit/add the help screen specific information.
  96.  
  97.                      ┌─────────────────────────────────┐
  98.                      │     Program:  HLTEST            │
  99.                      │    Variable:  VAR1              │
  100.                      │   Box Chars:                    │
  101.                      │   Box Color:  R                 │
  102.                      │  Text Color:  B+                │
  103.                      │      Header:  Help for screen   │
  104.                      │      Footer:  PgDn, Or any ke   │
  105.                      │  Head Color:  W+                │
  106.                      │  Foot Color:  RG+               │
  107.                      │      Shadow:  Y                 │
  108.                      │   Sh. Color:  N/N               │
  109.                      │     Overlay:  Y                 │
  110.                      │  Pause Time:  10                │
  111.                      └─────────────────────────────────┘
  112.  
  113.            NOTE:  At anytime while editing, the following keys are
  114.                   available:
  115.                   <ESC>    Abort.
  116.                   <ENTER>  Accept current field editing.
  117.                   <CTRL-U> Undo changes of current field.
  118.                   <HOME>   Go to beginning of current field.
  119.                   <PGDN>   Complete all fields displayed for editing.
  120.  
  121.         Program:  The name of the program when ALT-H was pressed.
  122.        Variable:  The name of the variable when ALT-H was pressed.
  123.                   NOTE:  There are different uses for this variable.
  124.                          By leaving this information blank, the help
  125.                          screen you define here will be a GENERIC help
  126.                          screen for that procedure.
  127.  
  128.  
  129.                                     Page 2                                    Page 2                                    Page 2                                    Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                        Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988                       Instant Help - INSTAHLP (c) 1988
  136.                               Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy                              Richard A. Murphy
  137.  
  138.  
  139.                          This allows you to have a combination of
  140.                          specific and non-specific help for that
  141.                          screen/procedure.  This means if you have three
  142.                          variables in an edit screen and you define a
  143.                          specific help for VAR1 and a non-specific help
  144.                          for VAR2, when F1 is pressed on VAR1, the
  145.                          specific help you wrote will come up.  But when
  146.                          the user presses F1 on VAR2 OR VAR3, the
  147.                          generic help you defined for VAR2 appears on
  148.                          BOTH!  You may edit the generic help on any
  149.                          variable that is not specific on that
  150.                          screen/procedure.  For this reason, I suggest
  151.                          (it is also good programming etiquette) to have
  152.                          each entry/edit screen in it's own procedure.
  153.                          This would allow you to make a generic help for
  154.                          each screen.  If you define more than one
  155.                          screen per procedure, and have a generic help,
  156.                          it will appear on ANY wait state in that
  157.